Inside Macintosh: QuickDraw GX Graphics /

Chapter 2 - Geometric Shapes / Geometric Shapes Reference

Functions / Getting and Setting Shape Geometries

GXSetPolygons

You can use the GXSetPolygons function to change the geometry of a polygon shape.

void GXSetPolygons(gxShape target, const gxPolygons *data);

target

A reference to the polygon shape whose geometry you want to change.

data

A pointer to the new polygon geometry.

DESCRIPTION

The GXSetPolygons function copies the geometry information from the data parameter into the geometry property of the target polygon shape. If the target shape is not a polygon shape, this function replaces the target shape with a polygon shape.

If you pass nil for the data parameter, the function sets the polygon shape to have zero contours.

If the target shape is locked (that is, its gxLockedShape shape attribute is set), this function posts the error shape_access_not_allowed.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
shape_is_nil
number_of_points_exceeds_implementation_limit
number_of_contours_exceeds_implementation_limit
size_of_polygon_exceeds_implementation_limit
count_is_less_than_one	(debugging version)
shape_access_not_allowed	(debugging version)

SEE ALSO

For general information about polygon geometries, see "Polygon Shapes" on page 2-22.

For the definition of the gxPolygons structure, see page 2-106.

To create a new polygon shape, use the GXNewPolygons function, which is described on page 2-116.

To examine the geometry of an existing polygon shape, use the GXGetPolygons function, which is described on page 2-130.

To draw a polygon geometry without creating a polygon shape, use the GXDrawPolygons function, which is described on page 2-161. To draw a polygon shape, use the GXDrawShape function, which is described in the chapter "Shape Objects" in Inside Macintosh: QuickDraw GX Objects.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help